Skip to content

OCM-19812: Improve local development documentation#569

Open
Alcamech wants to merge 1 commit intoopenshift:masterfrom
Alcamech:OCM-19812
Open

OCM-19812: Improve local development documentation#569
Alcamech wants to merge 1 commit intoopenshift:masterfrom
Alcamech:OCM-19812

Conversation

@Alcamech
Copy link

@Alcamech Alcamech commented Jan 23, 2026

What type of PR is this?

Documentation

What this PR does / why we need it?

Updates the local development.md documentation to:

  • Add step to delete the leader lease when scaling down the deployed MUO
  • Make the LOCAL mode ConfigMap step mandatory (not optional) for local development
  • Add UpgradeConfigSyncFailureOver4HrSRE to ignoredCriticals in the test ConfigMap (this al
    ert fires when the deployed MUO is scaled down)
  • Clarify that the operator must run as the MUO service account to bypass webhooks
  • Add OSDK_FORCE_RUN_MODE=local requirement for routes (both env vars are needed)
  • Fix inconsistent section header levels

Which Jira/Github issue(s) this PR fixes?

Fixes OCM-19812

Summary by CodeRabbit

  • Documentation
    • Reorganized development docs into consolidated top-level sections: Development Environment Setup, Running Locally, Running Remotely, Monitoring, and Maintenance.
    • Condensed and streamlined run/workflow guidance, removing older long-form examples and the separate "Trigger Reconcile" instructions.
    • Normalized command examples by removing shell prompts and modernizing invocations.
    • Retained and relocated macOS build notes to align with the new structure.

@openshift-ci-robot openshift-ci-robot added the jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. label Jan 23, 2026
@openshift-ci-robot
Copy link

openshift-ci-robot commented Jan 23, 2026

@Alcamech: This pull request references OCM-19812 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the story to target the "4.22.0" version, but no target version was set.

Details

In response to this:

What type of PR is this?

Documentation

What this PR does / why we need it?

Updates the local development.md documentation to:

  • Add step to delete the leader lease when scaling down the deployed MUO
  • Make the LOCAL mode ConfigMap step mandatory (not optional) for local development
  • Add UpgradeConfigSyncFailureOver4HrSRE to ignoredCriticals in the test ConfigMap (this al
    ert fires when the deployed MUO is scaled down)
  • Clarify that the operator must run as the MUO service account to bypass webhooks
  • Add OSDK_FORCE_RUN_MODE=local requirement for routes (both env vars are needed)
  • Fix inconsistent section header levels

Which Jira/Github issue(s) this PR fixes?

Fixes OCM-19812

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

@openshift-ci openshift-ci bot requested review from devppratik and ravitri January 23, 2026 19:54
@openshift-ci
Copy link
Contributor

openshift-ci bot commented Jan 23, 2026

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: Alcamech
Once this PR has been reviewed and has the lgtm label, please assign dustman9000 for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@Alcamech Alcamech mentioned this pull request Jan 26, 2026
2 tasks
@rawsyntax
Copy link
Member

LGTM

@coderabbitai
Copy link

coderabbitai bot commented Mar 2, 2026

Walkthrough

Reorganized docs/development.md into streamlined top-level headings (Development Environment Setup, Running Locally, Running Remotely, Monitoring, Maintenance); removed several nested subsections and the "Trigger Reconcile" block; standardized command examples by removing shell prompt characters; condensed and repositioned macOS notes and build/run guidance.

Changes

Cohort / File(s) Summary
Documentation Restructuring
docs/development.md
Rewrote development documentation: consolidated multi-level navigation into top-level sections, moved introductory note and macOS build note, promoted Makefile/Dependencies/Linting/Testing/Build guidance, relocated and shortened Run instructions into "Running Locally" and "Running Remotely", removed detailed step-by-step local run and "Trigger Reconcile" subsection, and standardized command formatting by removing leading shell prompts.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely summarizes the main change: improving local development documentation as indicated by the PR objectives and raw summary.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Stable And Deterministic Test Names ✅ Passed This PR exclusively modifies documentation file docs/development.md with no test code or Ginkgo test patterns, making the custom check not applicable.
Test Structure And Quality ✅ Passed PR contains only documentation changes to docs/development.md with no modifications to test files, making the test structure quality check not applicable.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Tip

Try Coding Plans. Let us write the prompt for your AI agent so you can ship faster (with fewer bugs).
Share your feedback on Discord.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@openshift-ci-robot
Copy link

openshift-ci-robot commented Mar 2, 2026

@Alcamech: This pull request references OCM-19812 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the story to target the "4.22.0" version, but no target version was set.

Details

In response to this:

What type of PR is this?

Documentation

What this PR does / why we need it?

Updates the local development.md documentation to:

  • Add step to delete the leader lease when scaling down the deployed MUO
  • Make the LOCAL mode ConfigMap step mandatory (not optional) for local development
  • Add UpgradeConfigSyncFailureOver4HrSRE to ignoredCriticals in the test ConfigMap (this al
    ert fires when the deployed MUO is scaled down)
  • Clarify that the operator must run as the MUO service account to bypass webhooks
  • Add OSDK_FORCE_RUN_MODE=local requirement for routes (both env vars are needed)
  • Fix inconsistent section header levels

Which Jira/Github issue(s) this PR fixes?

Fixes OCM-19812

Summary by CodeRabbit

  • Documentation
  • Restructured development documentation with new consolidated sections for "Development Environment Setup", "Running Locally", and "Running Remotely" to improve clarity.
  • Simplified command formatting and removed unnecessary command prompts.
  • Added macOS-specific build guidance.
  • Streamlined instructions and workflow descriptions for local and remote setups.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/development.md`:
- Around line 91-95: The documentation shows inconsistent test commands: the
prose says "make test" but the code block uses "make go-test"; update the docs
so both prose and the code block use the same command (choose either "make test"
or "make go-test") and make the change in the docs/development.md text
surrounding the testing instruction so the sentence and the fenced shell snippet
match (look for the lines containing "make test" and the code block with "make
go-test").

ℹ️ Review info

Configuration used: Repository: openshift/coderabbit/.coderabbit.yaml

Review profile: CHILL

Plan: Pro

Cache: Disabled due to data retention organization setting

Knowledge base: Disabled due to data retention organization setting

📥 Commits

Reviewing files that changed from the base of the PR and between 20d3ddc and 71b4afb.

📒 Files selected for processing (1)
  • docs/development.md

@openshift-ci-robot
Copy link

openshift-ci-robot commented Mar 4, 2026

@Alcamech: This pull request references OCM-19812 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the story to target the "4.22.0" version, but no target version was set.

Details

In response to this:

What type of PR is this?

Documentation

What this PR does / why we need it?

Updates the local development.md documentation to:

  • Add step to delete the leader lease when scaling down the deployed MUO
  • Make the LOCAL mode ConfigMap step mandatory (not optional) for local development
  • Add UpgradeConfigSyncFailureOver4HrSRE to ignoredCriticals in the test ConfigMap (this al
    ert fires when the deployed MUO is scaled down)
  • Clarify that the operator must run as the MUO service account to bypass webhooks
  • Add OSDK_FORCE_RUN_MODE=local requirement for routes (both env vars are needed)
  • Fix inconsistent section header levels

Which Jira/Github issue(s) this PR fixes?

Fixes OCM-19812

Summary by CodeRabbit

  • Documentation
  • Reorganized development docs into consolidated top-level sections: Development Environment Setup, Running Locally, Running Remotely, Monitoring, and Maintenance.
  • Condensed and streamlined run/workflow guidance, removing older long-form examples and the separate "Trigger Reconcile" instructions.
  • Normalized command examples by removing shell prompts and modernizing invocations.
  • Retained and relocated macOS build notes to align with the new structure.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
docs/development.md (1)

123-125: Make scale-down/lease cleanup idempotent

These setup commands fail noisily when MUO or the lease is already absent. Consider --ignore-not-found=true so local setup can be rerun safely.

Suggested doc update
-oc scale deployment managed-upgrade-operator -n openshift-managed-upgrade-operator --replicas=0
-oc delete lease managed-upgrade-operator-lock -n openshift-managed-upgrade-operator
+oc scale deployment managed-upgrade-operator -n openshift-managed-upgrade-operator --replicas=0 --ignore-not-found=true
+oc delete lease managed-upgrade-operator-lock -n openshift-managed-upgrade-operator --ignore-not-found=true
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/development.md` around lines 123 - 125, Update the two teardown commands
to be idempotent by adding the ignore-not-found flag: modify the oc scale
command for the deployment managed-upgrade-operator and the oc delete command
for the lease managed-upgrade-operator-lock to include --ignore-not-found=true
so rerunning the setup/cleanup won’t error if the deployment or lease is already
absent.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@docs/development.md`:
- Around line 123-125: Update the two teardown commands to be idempotent by
adding the ignore-not-found flag: modify the oc scale command for the deployment
managed-upgrade-operator and the oc delete command for the lease
managed-upgrade-operator-lock to include --ignore-not-found=true so rerunning
the setup/cleanup won’t error if the deployment or lease is already absent.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository: openshift/coderabbit/.coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: d91bca20-cc0a-4254-bc0b-87f748ae8318

📥 Commits

Reviewing files that changed from the base of the PR and between 71b4afb and 1d5a68d.

📒 Files selected for processing (1)
  • docs/development.md

@openshift-ci
Copy link
Contributor

openshift-ci bot commented Mar 4, 2026

@Alcamech: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

jira/valid-reference Indicates that this PR references a valid Jira ticket of any type.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants